home *** CD-ROM | disk | FTP | other *** search
/ The Business Master (3rd Edition) / The Business Master (3rd Edition).iso / files / finacial / capgain3 / cgzdc31i.exe / CG03.DOC < prev    next >
Encoding:
Text File  |  1992-10-19  |  13.1 KB  |  349 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                             Chapter 3 - Installation
  7.  
  8.  
  9.      ===>>> 
  10.      Be  sure  to  make  backup  copies  of  your  original  Capital  Gainz
  11.      diskette(s). Electronic  media such  as diskettes are  easily damaged,
  12.      and a spare can become very valuable in a crisis situation.
  13.  
  14.          This chapter describes the Capital Gainz installation procedure in
  15.      detail.  The installation  program, INSTALL.EXE,  is straight-forward,
  16.      and  you should not encounter  any problems. So,  unless you're having
  17.      problems, or  just want to know what's  happening during installation,
  18.      you can skip to the next chapter.
  19.  
  20.      3.1  Installation
  21.  
  22.  
  23.      3.1.1  Set Parameters
  24.  
  25.      [[Screen not in online version of documentation.]]
  26.  
  27.          The Install Form accepts the following installation parameters:
  28.  
  29.      o  Install  From Drive,  the letter  of  the  drive you  are installing
  30.         from.  This is  probably  A or  B, but  could be  a hard  drive. The
  31.         default is A.
  32.  
  33.      o  The Directory you  are installing from. This  is usually \, but  may
  34.         be another  directory if you are installing from your hard disk. The
  35.         default is \.
  36.  
  37.      o  Install To  Drive, the letter  of the drive  you are  installing to.
  38.         This is  probably C  or D,  but could  be F,  G, or another  network
  39.         drive. The default is C.
  40.  
  41.      o  Base Directory,  the main directory you  are installing  to. This is
  42.         where the  main programs are installed.  The default  is \CAPGNZ. If
  43.         the directory does not  exist, you are asked  if you want  to create
  44.         it.
  45.  
  46.      o  Whether  or not  you  want  to Install  the Program  Files.  This is
  47.         usually  the  case, but  you may  be installing  documentation after
  48.         having already installed the programs. The default is YES.
  49.  
  50.      o  Whether  or not  you want to  Install the Program  Data. These files
  51.         include  the Security Type  File, the  Password File,  and the Error
  52.         Message  File.  The Security  Type  File  is  only  installed if  it
  53.         doesn't exist. You should install these  if you install the  Program
  54.         Files. If  you  install  these files,  they  are  put  in  the  Base
  55.         Directory. The default is YES.
  56.  
  57.  
  58.                            Capital Gainz Users Manual                   3-1
  59.  
  60.  
  61.  
  62.  
  63.      o  Whether or  not to  Install the  Doc Files.  If you ordered  a bound
  64.         manual,  you  can save  disk  space  by  not  installing the  online
  65.         version  of the  manual.  If you  don't install  it, you  won't have
  66.         online help and can't access the  manual via the View  Documentation
  67.         function. The default is YES.
  68.  
  69.         o (If you specified YES to install the Doc Files.) The Directory to
  70.           install  the Doc  Files to.  The default  is \CAPGNZ\DOC.  If the
  71.           directory does not exist, you are asked if you want to create it.
  72.  
  73.      o  Whether  or not to  Install the  Utility Files.  The Utility Program
  74.         includes   some   non-essential   functions,   such   as   copy/move
  75.         securities. You can save disk space  by not installing these  files.
  76.         If you install these files, they are put in the Base Directory.  The
  77.         installation program requires you to install  these files if you are
  78.         upgrading to a new version of Capital Gainz. The default is YES.
  79.  
  80.      o  Whether or not to Install the  Graphics Files. The Graphics  Program
  81.         lets  you generate graphs  based on  your Capital  Gainz data files.
  82.         You  can save  disk  space  by not  installing these  files.  If you
  83.         install  these  files, they  are  put  in  the  Base Directory.  The
  84.         default is YES.
  85.  
  86.      o  Whether  or not  to  Install the  Demo/Tutorial.  The  demo/tutorial
  87.         screen show is  the best  way to get  aquainted with Capital  Gainz.
  88.         You should  install it, especially if  you're new  to Capital Gainz.
  89.         The default is YES.
  90.  
  91.         o (If you specified YES  to install the Demo Files.)  The Directory
  92.           to install the Demo Files to. The default is \CAPGNZ\DEMO. If the
  93.           directory does not exist, you are asked if you want to create it.
  94.           For  easy cleanup when you're  done with it,  install the demo in
  95.           its own directory.
  96.  
  97.      o  Whether  or  not to  Install  the  Example  Data.  The example  data
  98.         consists  of a  portfolio  of security  information.  Install  these
  99.         files if you'd like to  play around with some  data before recording
  100.         your own investment information. Example data can't be installed  if
  101.         you've already  run Capital Gainz and  entered data.  The default is
  102.         YES.
  103.  
  104.      o  The Registration Number. If you are  installing an upgrade, then the
  105.         default  is your  current version's registration  number. Otherwise,
  106.         you  need to enter  the registration  number from  the Capital Gainz
  107.         diskette.
  108.  
  109.      o  Your Name. This personalizes the startup screen.
  110.  
  111.      o  Whether  or not to  Modify CONFIG.SYS.  Capital Gainz  can have many
  112.         files  (index and data) open at  a given time,  so the FILES line in
  113.         CONFIG.SYS  should be  set to  around 40.  The installation  program
  114.         will scan your CONFIG.SYS  file, and add or modify the FILES line so
  115.  
  116.      3-2                   Capital Gainz Users Manual
  117.  
  118.  
  119.  
  120.  
  121.         it's  set to  40 or  the current  value, whichever  is greater.  The
  122.         default  is YES. If  you specify  NO, then  the installation program
  123.         tells you that the FILES  line in your CONFIG.SYS must be set to 40.
  124.         If this value is  changed, you must reboot your computer for the new
  125.         value to take effect.
  126.  
  127.      o  Whether or not to  Copy CG.BAT, the startup  batch file, to the root
  128.         directory. It's created  in the program  directory. By answering YES
  129.         to this question, CG.BAT  is also copied to  the root (\) directory.
  130.         The default is NO.
  131.  
  132.      o  The  Temporary  Directory, where  temporary  files  are  created  by
  133.         Capital  Gainz. The first thing  CG.BAT does on startup is to delete
  134.         any .TMP  files  in  this directory.  The default  is  \TMP. If  the
  135.         directory does not exist, you are asked if you want to create it.
  136.  
  137.      o  Whether  or  not  to  Use  Built-in  Screen Blanker.  Capital  Gainz
  138.         automatically  blanks the  screen after  10 minutes  of  inactivity.
  139.         Sometimes this screen blanker conflicts with other screen  blankers,
  140.         so specify NO if you already have a screen blanker installed.
  141.  
  142.      o  What  the Current Installed Version is. If you  are upgrading from a
  143.         previous version of Capital Gainz, it's  very important that you set
  144.         this correctly.  Otherwise, the  upgrade process will  fail. If  you
  145.         enter an invalid revision number, a  list of valid revision  numbers
  146.         is shown. The default is NONE.
  147.  
  148.      o  If  you are  upgrading  to  a new  revision, you  need to  enter the
  149.         directories to Upgrade Data  In. The first directory is the same  as
  150.         the Program File Directory. The other  directories are blank. If you
  151.         previously installed  Capital  Gainz  and  always ran  it  from  the
  152.         program directory, only enter the first  directory. However, you may
  153.         have multiple directories set up with  different data files, as this
  154.         was  the  only way  to maintain  multiple portfolios  before version
  155.         3.0. If  so,  enter the  directories  containing  data files  to  be
  156.         upgraded. Entry is completed when you leave a directory blank.
  157.  
  158.      Function keys at the bottom of the screen are:
  159.  
  160.      o  F1:Help - there is a special, online help file for the  installation
  161.         program (INSTALL.HLP).
  162.  
  163.      o  F2:View  README  File -  display  the  README.DOC  file,  containing
  164.         important  information  and  last  minute  changes.  This  file   is
  165.         displayed a  screen at a  time. Hitting Esc  returns to the  Install
  166.         Form, and any other key displays the next page.
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.                            Capital Gainz Users Manual                   3-3
  175.  
  176.  
  177.  
  178.  
  179.      3.1.2  Installation Process
  180.  
  181.          After  answering all  the questions,  the installation  process is
  182.      executed:
  183.  
  184.      1) The installation program  checks if there is enough free disk space
  185.      to install the requested files. If not, a message is displayed and you
  186.      can proceed anyway.
  187.  
  188.      2)  The  installation   log,  INSTALL.LOG,  is  created  in  the  Base
  189.      Directory.  If it already exists, it is removed first. As installation
  190.      progresses, messages are written to this log.
  191.  
  192.      3) Any old files no longer used by Capital Gainz are removed.
  193.  
  194.      4) The installation  information file, INSTALL.INF,  is read from  the
  195.      installation disk to determine archive names, types, and contents. 
  196.  
  197.      5)  Based on  your answers  in the  Install Form  and the  contents of
  198.      INSTALL.INF,  CGINST.BAT  is  built.  This  batch  file  contains  the
  199.      commands  to  install Capital  Gainz.  Also,  INSTALL.UPG is  created,
  200.      containing  information used  by the Utility  Program to  upgrade your
  201.      data files.
  202.  
  203.      6)  CGINST.BAT is executed after shelling  to DOS. The last thing that
  204.      CGINST.BAT  does  is call  the Utility  Program  to upgrade  your data
  205.      files, if necessary.
  206.  
  207.      7) When CGINST.BAT completes, the  installation program deletes it and
  208.      verifies that the correct files were installed.
  209.  
  210.      8) If you said  to modify your CONFIG.SYS file, then it  is changed if
  211.      necessary.
  212.  
  213.      9) CG.BAT, the startup batch file, is constructed.
  214.  
  215.      10)  CAPGNZ.INF, the  Capital Gainz  information file,  is  created or
  216.      updated based on the installation.
  217.  
  218.      11) If any errors were encountered during installation, INSTALL.LOG is
  219.      displayed.  Installation ends, and you should fix the problems and try
  220.      to re-install.
  221.  
  222.      ===>>> When installation is complete, you can look at the installation
  223.      log, INSTALL.LOG, to see exactly what was done. This file will include
  224.      messages indicating any files that had to be renamed. For instance, if
  225.      CAPGNZBU.BAT existed before installation, it is copied to another file
  226.      before the new CAPGNZBU.BAT is installed. This way, any changes you've
  227.      made  to files  can be retrieved.  Also, any  files that  could not be
  228.      installed  are listed.  The installation  program can  be run  as many
  229.      times as needed. If you  incorrectly entered your registration number,
  230.      decided  you  would  like  to  install the  online  documentation,  or
  231.  
  232.      3-4                   Capital Gainz Users Manual
  233.  
  234.  
  235.  
  236.  
  237.      inadvertently  deleted CAPGNZ.EXE,  just  invoke it  again. Your  data
  238.      files will not be  affected. Alternatively, you can make  some changes
  239.      simply by modifying CAPGNZ.INF and CG.BAT with a text editor.
  240.  
  241.      3.1.3  Clean Up
  242.  
  243.          After trying Capital Gainz for awhile, you may want to  clean up a
  244.      few files.
  245.  
  246.      o  If you installed the  demo, you can delete  it when you're done with
  247.         it:
  248.  
  249.         C:> CD \CAPGNZ\DEMO
  250.         C:> DEL *.*
  251.         C:> CD ..
  252.         C:> RMDIR DEMO
  253.  
  254.      o  If you installed  the example data files,  you can delete them  when
  255.         you're  done.  First,  delete  the  portfolio  from  Capital  Gainz'
  256.         Portfolio Table. This deletes all of  the activity. To remove global
  257.         data, such  as global  securities, prices, and brokers,  execute the
  258.         following from the DOS command line:
  259.  
  260.         C:> CD \CAPGNZ
  261.         C:> DEL GSEC.??? 
  262.         C:> PRC_HST.??? 
  263.         C:> BROKER.???
  264.  
  265.      o  If you installed the documentation files,  and use the manual rather
  266.         than online help, you can delete them:
  267.  
  268.         C:> CD \CAPGNZ\DOC
  269.         C:> DEL *.*
  270.         C:> CD ..
  271.         C:> RMDIR DOC
  272.  
  273.      3.2  Installation Failures
  274.  
  275.          Installation failures can be classified as follows:
  276.  
  277.      o  Failure  before  all  of the  files are  installed.  Try to  fix any
  278.         problems reported, and run INSTALL.EXE again.
  279.  
  280.      o  Failure after  the files  are installed,  but before  the data  file
  281.         upgrade  completes. In this  case, you're  left with  old data files
  282.         but  new versions  of the  Capital  Gainz  executables. You  need to
  283.         manually execute  the Utility Program,  CGUTIL.EXE, to upgrade  your
  284.         data files. This program is described in Chapter 18.
  285.  
  286.          Common installation problems include: bad  diskettes, corrupt data
  287.      caused by electronic transmission errors, incorrect composition of the
  288.      archives on the diskettes,  and an incorrectly constructed INSTALL.INF
  289.  
  290.                            Capital Gainz Users Manual                   3-5
  291.  
  292.  
  293.  
  294.  
  295.      file.  The result of these  kinds of problems  are installation errors
  296.      indicating:  invalid archive,  invalid  archive format,  or disk  read
  297.      errors. 
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.      3-6                   Capital Gainz Users Manual
  349.